home *** CD-ROM | disk | FTP | other *** search
/ Acorn Risc Technologies StrongARM CD-ROM / Acorn Risc Technologies StrongARM CD-ROM.iso / ftp / documents / appnotes / 031_045 / 041c / Text
Encoding:
Text File  |  1993-08-02  |  7.3 KB  |  182 lines
  1. 4th August 1992
  2. -----------------------------------------------------------------------------
  3. Support Group Application Note 
  4. Number: 041
  5. Issue: 3 
  6. Author:
  7. -----------------------------------------------------------------------------
  8.  
  9. Master 128 Welcome Guide Addendum
  10.  
  11. -----------------------------------------------------------------------------
  12. Applicable Hardware: BBC Master 128
  13.  
  14. Related Application Notes:
  15.  
  16.  
  17. -----------------------------------------------------------------------------
  18. Copyright (C) Acorn Computers Limited 1992
  19.  
  20. Every effort has been made to ensure that the information in this leaflet is 
  21. true and correct at the time of printing. However, the products described in
  22. this leaflet are subject to continuous development and improvements and
  23. Acorn Computers Limited reserves the right to change its specifications at
  24. any time. Acorn Computers Limited cannot accept liability for any loss or
  25. damage arising from the use of any information or particulars in this
  26. leaflet. ACORN, ECONET and ARCHIMEDES are trademarks of Acorn Computers
  27. Limited.
  28. -----------------------------------------------------------------------------
  29. Support Group
  30. Acorn Computers Limited
  31. Acorn House
  32. Vision Park
  33. Histon
  34. Cambridge       CB4 4AE
  35. -----------------------------------------------------------------------------
  36.  
  37.  
  38. THE WELCOME DISC
  39.  
  40. Unlike most software supplied by Acorn, the Welcome disc is not protected
  41. with a write protect tab.  care must therefore be taken to ensure that the
  42. software supplied on the disc is not either overwritten or deleted.
  43.  
  44. The disc is supplied without a write protect tab to allow the disc to be
  45. configured, where necessary, for use with an 80 track disc drive.  It is
  46. recommended that the disc should be write protected as soon as possible
  47. which, if you will be using a 40 track drive, should be before the disc is
  48. used.  If you will be using an 80 track disc drive, the write protect tab
  49. should not be put in place until after the first successful use of the
  50. WELCOME80 utility and the subsequent Welcome programs.
  51.  
  52. NOTE:  When the disc has been write protected, it will not be possible to
  53. add to the database provided with the DBASE program since this requires
  54. DBASE to write to the disc.
  55.  
  56.  
  57. BAS128
  58.  
  59. This version of BBC BASIC gives the user access to a full 64K of memory for
  60. BASIC programs.  A copy of BAS128 is supplied on both the Welcome cassette
  61. and the Welcome disc.  On the cassette it is located towards the end of side
  62. two, on the disc it is located in the 80 track library.
  63.  
  64. BAS128 is loaded from the disc by typing:
  65.         *MOUNT <DRIVE NUMBER>
  66.         *LIB LIBRARY
  67.         *BAS128
  68.  
  69. and from cassette by typing:
  70.         *RUN BAS128
  71.  
  72. The screen will be cleared and the banner BBC BASIC will appear together
  73. with a bytes free message 64K.  The ">" prompt will be displayed and
  74. commands can be issued in the same way as for the ROM-based BASIC.
  75.  
  76. If you are familiar with the use of BASIC and intend to write your own
  77. program, you may need to be aware of the technical differences between the
  78. ROM-based BASIC and the disc-based BAS128.  The key point is that this disc
  79. based version of BBC BASIC is loaded into the RAM area in which a user
  80. program would normally reside.  The 64K area of additional "sideways" RAM is
  81. then made available for other user program.
  82.  
  83. The detailed differences between the two BASICs are as follows:
  84.  
  85. 1.  When using BAS128, the 64K of additional memory appears to be a
  86. continuous address space above the normal 64K address space of the computer. 
  87. Thus addresses &000000 to &00FFFF refer to normal memory and addresses
  88. &010000 to &01FFFF refer to the 64K bytes of sideways RAM.
  89.       PAGE defaults to &10000.
  90.       HIMEM defaults to &20000
  91.       Similarly, LOMEM and TOP are addressed in this way.
  92.  
  93. 2.  Indirection Operators.
  94.      Statements such as DIM code 100 will assign a 17-bit value to "code". 
  95. Indirection operators may then be used to read and write data into the area
  96. of memory reserved by the DIM statement; eg:
  97.        !code=27128, PRINT code?3 or $(code+27)="HELLO"
  98. Indirection operators will address normal memory if the calculated pointer
  99. is in the range &000000 to &00FFFF and will address sideways RAM if the
  100. pointer is in the range &010000 to &01FFFF.
  101.  
  102. 3.  The Assembler.
  103.      This will operate using O% and P% as 17-bit pointers.
  104.       
  105.       a)  The Destination Pointer
  106.            If the destination for the code is in the range &000000 to
  107.                 &00FFFF, then normal memory is referenced.  Addresses from
  108.                 &01000 to &01FFFF refer to sideways RAM.
  109.  
  110.       b)  The Program Counter
  111.             The code produced is adjusted so that address references in the
  112.                 range &010000 to &01FFFF refer to sideways RAM addresses
  113.                 &008000 to &00BFFF.  References from one bank of sideways
  114.                 RAM to another are trapped giving a BANK error eg:
  115.         P%=&13F00 : [JSR &1CF34
  116.            will give a BANK error.
  117.            When compiling, any code generated over a bank boundary is
  118.                 trapped, resulting in a WRAP error. Thus, the maximum amount
  119.                 of code that can be generated at one time is 16Kbytes;  eg:
  120.         P%=&13FFC : [LDA #0 : TAY : SEC : SBC &70
  121.                 will give a WRAP error since execution cannot pass from one
  122.                 bank to the next directly
  123.  
  124. 4.  SHADOW mode will be forced on so that BAS128 can reside in RAM between
  125. &3000 and &8000.  The remaining memory from OSHWM to &3000 may be used by
  126. BAS128 for workspace.
  127.  
  128. 5.  The LOAD, SAVE and CHAIN commands make use of the OSGBPB routine.
  129.  
  130. 6.  The following commands, which are available under BASIC IV are not
  131. implemented with BAS128:
  132.         LIST IF
  133.         EDIT
  134.         EDIT IF
  135. Along with these commands, the TIME$ pseudo variable is not available from
  136. BAS128.  For detailed information on these commands, please refer to the
  137. Welcome Guide.
  138.  
  139.  
  140. The CONVERT utility
  141.  
  142. It is sometimes the case that software, which works correctly on a BBC micro
  143. model B, will not work on a Master Series computer.  the reason for this
  144. will usually be found in the way in which the software is written.  Because
  145. of the need for extra space, or a non-standard operation, software authors
  146. may use areas of memory not normally provided for them.  it may also be the
  147. case that the software relied on a specific hardware feature, peculiar to
  148. only one of the BBC Micro range.
  149.  
  150. The Convert utility can often help in such cases by intercepting certain
  151. types of routine known to be used in some software.  Unfortunately it is not
  152. possible to trap all of these routines and it is inevitable that some
  153. software will still not work even when the convert utility is used.
  154.  
  155. This utility may be found in both the library on the Welcome disc and at the
  156. end of side two of the the Welcome cassette.  
  157.  
  158.  
  159.  
  160. To use the utility from the Welcome disc, enter the following:
  161.         *MOUNT <DRIVE NUMBER>
  162.         CHAIN "CONVERT"
  163.  
  164. To use the utility from the Welcome cassette you should enter:
  165.         CHAIN "CONVERT"
  166.  
  167. Convert, which uses one of the 16K sideways RAM pages, will remain active
  168. until the machine is switched off.
  169.  
  170.  
  171. ERRATA:
  172.  
  173. Please note that the program DBASE, as described on page 32 of the Welcome
  174. Guide, is NOT present on the Welcome cassette.
  175.  
  176. When using TIMPAINT, the R key replaces the CTRL TAB command for the
  177. purposes of clearing the screen.
  178.  
  179. On page 205 the phrase SHIFT+keypad 0 should read SHIFT+keypad 1.
  180.         
  181.  
  182.